Skip to content

[CF1] ELI5 on CASB docs#29703

Merged
codyanthony850 merged 4 commits intoproductionfrom
jun/eli5/casb
Apr 10, 2026
Merged

[CF1] ELI5 on CASB docs#29703
codyanthony850 merged 4 commits intoproductionfrom
jun/eli5/casb

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented Apr 8, 2026

Fixes grammar, navigation path, and terminology inconsistencies across CASB documentation, identified during an ELI5 clarity review of the cloud-and-saas-findings/ folder.

  • Grammar fix (casb-dlp.mdx): "files stored in a SaaS application contains" → "contain" (subject-verb agreement).
  • Navigation path (troubleshoot-casb.mdx, integrations/.../casb.mdx): Changed **Integrations** > **Cloud & SaaS** to **Cloud & SaaS findings** > **Integrations** to match the canonical path used in manage-findings.mdx, casb-dlp.mdx, and the manage-integrations partial.
  • Toggle label (troubleshoot-casb.mdx, integrations/.../casb.mdx): Changed **Findings scanning** to **Scan for findings** to match the manage-integrations partial. Also removed an extra step ("Go to CASB") not present in the partial.
  • Terminology (troubleshoot-casb.mdx, integrations/.../casb.mdx): Replaced the undocumented "Suppress" action with a cross-link to the ignore/hide workflow documented in manage-findings.mdx.

Note: The toggle label ("Scan for findings" vs. "Findings scanning") should be verified against the current dashboard UI. This PR aligns with the manage-integrations partial, which is the most widely referenced source.

…istencies

- Fix subject-verb agreement in casb-dlp.mdx ('contains' -> 'contain')
- Align troubleshoot navigation path to canonical 'Cloud & SaaS findings > Integrations'
- Align toggle label to 'Scan for findings' per manage-integrations partial
- Replace undocumented 'Suppress' action with cross-link to ignore/hide workflow
- Apply same fixes to duplicate troubleshoot file in integrations folder
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-one/cloud-and-saas-findings/ @Maddy-Cloudflare, @codyanthony850, @cloudflare/pcx-technical-writing, @cloudflare/product-owners
/src/content/docs/cloudflare-one/ @ranbel, @Maddy-Cloudflare, @codyanthony850, @cloudflare/pcx-technical-writing, @cloudflare/product-owners

Oxyjun added 2 commits April 8, 2026 16:20
- Split long CASB intro sentence and explain 'API-driven' inline (index.mdx)
- Add DLP profile parenthetical definition (casb-dlp.mdx)
- Add caution callout for full-scan vs incremental-scan distinction (casb-dlp.mdx)
- Rephrase ambiguous Java/R minimum size limitation (casb-dlp.mdx)
- Add OCR cross-link to clarify that CASB does not scan images but DLP does via Gateway (casb-dlp.mdx)
- Add parenthetical for 'data at rest' (manage-findings.mdx)
- Add ignore vs hide comparison before procedures (manage-findings.mdx)
- Clarify Failed vs Rejected remediation statuses (manage-findings.mdx)
- Rewrite Gateway policy intro to bridge CASB-to-Gateway concept (manage-findings.mdx)
- Add finding ID location hint (troubleshoot-casb.mdx)
- [Text-based files](/cloudflare-one/data-loss-prevention/#supported-file-types) such as documents, spreadsheets, and PDFs. Images are not supported.
- Files less than or equal 100 MB in size.
- Source code with a minimum size of 5 KB for Java and R.
- [Text-based files](/cloudflare-one/data-loss-prevention/#supported-file-types) such as documents, spreadsheets, and PDFs. Images are not scanned by CASB. For image scanning via inline traffic inspection, refer to [Optical Character Recognition (OCR)](/cloudflare-one/data-loss-prevention/dlp-profiles/advanced-settings/#optical-character-recognition-ocr).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OCR now works in CASB, we can remove this limitation

Copy link
Copy Markdown
Contributor

@caley-b caley-b left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some changes to consider post-feedback from Alexa.

To trigger a new scan:

1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Integrations** > **Cloud & SaaS integrations**.
1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Cloud & SaaS findings** > **Integrations**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we go ahead and update the link to go In the Cloudflare dashboard, go to Zero Trust...

But I actually think the old text is the correct way of navigating there. @alexamavrogianis do you agree? If we drop them in the Cloud & SaaS findings area, they will then have to go to Cloud & SaaS findings > Overview >> Manage integrations >> View integrations ---> Integrations

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, good catch. The Integrations > Cloud & SaaS integrations is more effective nav structure

To trigger a new scan:

1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Integrations** > **Cloud & SaaS integrations**.
1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Cloud & SaaS findings** > **Integrations**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same thing here potentially as above.


### Ignore a finding

1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Cloud & SaaS findings** > **Posture Findings**.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. In [Cloudflare One](https://one.dash.cloudflare.com), go to **Cloud & SaaS findings** > **Posture Findings**.
1. In the [Cloudflare dashboard](https://dash.cloudflare.com), go to **Zero Trust** > **Cloud & SaaS findings** > **Posture Findings**.

@codyanthony850 codyanthony850 merged commit d7e6772 into production Apr 10, 2026
19 checks passed
@codyanthony850 codyanthony850 deleted the jun/eli5/casb branch April 10, 2026 18:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants